packages/create-dojo/src/commands/start.ts (3)

69-79: Enhance error handling and robustness of the cloning operation.

While the switch to npx degit is a good improvement, consider these enhancements:

1. Add a check for npx availability
2. Provide more detailed error messages to help users troubleshoot

Consider this implementation:

     // Clone dojo-starter
     console.log(`Downloading dojo-starter...`);
+    // Check if npx is available
+    const npxCheck = spawn.sync('npx', ['--version'], { stdio: 'ignore' });
+    if (npxCheck.status !== 0) {
+        throw new Error('npx is required but not found. Please install [email protected] or later.');
+    }
+
     const starterCloneResult = spawn.sync(
         "npx",
         ["degit", `dojoengine/dojo-starter`, dojoStarterPath],
         { stdio: "inherit" }
     );

     if (starterCloneResult.status !== 0) {
-        throw new Error(`Failed to clone dojo-starter repository.`);
+        throw new Error(
+            `Failed to clone dojo-starter repository. ` +
+            `Please ensure you have internet connectivity and the repository exists at ` +
+            `https://github.com/dojoengine/dojo-starter`
+        );
     }

---

Line range hint 39-46: Review directory structure for path compatibility.

The current implementation creates dojo-starter inside the project directory, but the PR mentions issues with relative paths in examples referring to ../../worlds/dojo-starter. This structure might still cause issues with example configurations.

Consider these options:

1. Update all example configurations to use relative paths based on the new structure
2. Create a symlink from ../../worlds/dojo-starter to the local dojo-starter directory
3. Document the expected directory structure in the README

Would you like me to help implement any of these solutions?

---

Line range hint 1-8: Enhance template validation and error handling.

The template validation could be improved to:

1. Validate template existence before starting the initialization
2. Handle network issues when fetching templates
3. Provide better error messages for template-related issues

Consider enhancing the template validation:

     .action(async (options) => {
         try {
             const cwd = path.resolve(options.cwd);
             let template: string;
+            
+            // Validate template repository existence
+            const validateTemplate = async (templateName: string) => {
+                const url = `https://api.github.com/repos/dojoengine/dojo.js/contents/examples/${templateName}`;
+                try {
+                    const response = await fetch(url);
+                    return response.status === 200;
+                } catch (error) {
+                    return false;
+                }
+            };

             if (options.template) {
                 const selectedTemplate = templates.find(
                     (tpl) => tpl.value === options.template
                 );
                 if (!selectedTemplate) {
                     console.error(
-                        `Template "${options.template}" not found. Available templates are: ${templates
+                        `Template "${options.template}" not found.\n\nAvailable templates:\n${templates
+                            .map((tpl) => `- ${tpl.value}: ${tpl.description}`)
+                            .join("\n")}`
-                            .map((tpl) => tpl.value)
-                            .join(", ")}`
                     );
                     process.exit(1);
                 }
+                if (!(await validateTemplate(selectedTemplate.value))) {
+                    throw new Error(
+                        `Template "${selectedTemplate.value}" exists in the list but ` +
+                        `could not be accessed. Please check your internet connection ` +
+                        `or report this issue.`
+                    );
+                }
                 template = selectedTemplate.value;
             }

Also applies to: 144-167

Configuration used: CodeRabbit UI
Review profile: CHILL